       EPSON JavaPOS ADK Version 1.14.32  Linux  Installation Guide
                                                       Seiko Epson Corporation
                                                               Mar. 27, 2024
Trademarks:
 Microsoft, Windows, Windows Server and Windows Vista are trademarks or
 registered trademarks of Microsoft Corporation in the United States and/or
 other countries.
 Linux is a trademark or registered trademark of Linus Torvalds in the U.S.A.
 and/or other countries.
 Red Hat is a registered trademark of Red Hat, Inc.
 SUSE is a registered trademark of SuSE Linux AG, a Novell business.
 CentOS and the CentOS Logo are trademarks or registered trademarks of CentOS
 ltd.
 JBuilder is a trademark of Borland Software Corporation in the United States
 and other countries.
 EPSON and ESC/POS are registered trademarks of Seiko Epson Corporation.
 Java and all Java-based trademarks are registered trademarks of Oracle 
 Corporation, its subsidiaries, and/or affiliates in the U.S. and other 
 countries.
 Other product and company names used herein are for identification purposes
 only and may be trademarks or registered trademarks of their respective 
 companies.
 Epson disclaims any and all rights in those marks.


Chapter1 Introduction:
 The following hardware and software configuration is required when installing
 EPSON JavaPOS ADK.
 See ReleaseNotes.txt for detailed version information.

 1-1 Computer
     IBM PC/AT compatible
     - Please follow the specifications recommended by your OS for system
       requirements (CPU, RAM, etc.).
     - The minimum supported screen resolution on Linux is 800x600.
     - Operating system
         [In case of Full install]
             Red Hat Enterprise Linux 6.10 (32bit/64bit)
             Red Hat Enterprise Linux 7.0 (64bit)
             SuSE Linux Enterprise 11.3 (32bit/64bit)
             SuSE Linux Enterprise 15.0 (64bit)
             CentOS Linux 6.10 (32bit/64bit)
             CentOS Linux 7.0 (64bit)
             Ubuntu 16.04 (32bit/64bit)
             Ubuntu 18.04 (64bit)
             Ubuntu 20.04 (64bit)
             Ubuntu 22.04 (64bit)
         [In case of no SetupPOS install]
           Support only:
             Red Hat Enterprise Linux 7.9 (64bit)
             SuSE Linux Enterprise 15.0 (64bit)
             CentOS Linux 7.9 (64bit)
             Ubuntu 16.04 (32bit/64bit)
             Ubuntu 18.04 (64bit)
             Ubuntu 20.04 (64bit)
             Ubuntu 22.04 (64bit)
     - Java Virtual Machine
     - libusb
        Required to use USB.
     - Java Advanced Imaging (JAI)
        Required to use CheckScanner.
        See ReleaseNotes.txt for where to get it.


Chapter2 Caution:
 - Please connect a printer after installing JavaPOS driver.
 - If you execute a JavaPOS application without root access right, you have to 
   modify "/lib/udev/rules.d/50-udev-default.rules" file with Root access 
   belong to OS.
     Before: SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0664"
     After: SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"


Chapter3 Installation:
 3-1 Installing Java
     The following instructions use Java SE Runtime Environment 1.8.0_351
     (Oracle) as an example. Users need only install the Java Runtime 
     Environment (JRE), while developers should install the Java Development 
     Environment (JDK). 
     Unless otherwise noted, the following instructions assume the user is 
     installing the JRE.
       1. Launch a terminal window and enter the following command to get root 
          privileges.
            su
            Password:xxx
       2. Download the jre-8u351-linux-i586.tar.gz file from Oracle's java 
          download website 
       3. Make the file executable by opening a terminal window to the directory
          where it is saved, and typing:
            mkdir -p -m a+w /usr/java
            cp jre-8u351-linux-i586.tar.gz /usr/java
            cd /usr/java
            tar xvfz jre-8u351-linux-i586.tar.gz
       4. Type the following at the terminal to set install envirment:
            JAVA_HOME=/usr/java/jre1.8.0_351
            PATH=$JAVA_HOME/bin:$PATH
           export JAVA_HOME PATH
       5. Type the following command to confirm the java
            java -version

          Confirm that the following results are displayed.
            java version "1.8.0_351"
            Java(TM) SE Runtime Environment (build 1.8.0_351-b10)
            Java HotSpot(TM) Client VM (build 25.351-b10, mixed mode)

 3-2 Installing Java Advanced Imaging (JAI)
     Please install Java Advanced Imaging (JAI) in case of using CheckScanner.
       1. Download the JAI.
         Users: Install the Java Runtime Environment (JRE) version.
         Developers: Install the Java Development Environment (JDK) version.
       2. Copy the JAI to your Java directory:
            cp jai-1_1_2_01-lib-linux-i586-jre.bin /usr/java/jre1.8.0_351
       3. Execute the JAI installer:
            cd /usr/java/jre1.8.0_351
            chmod 755 jai-1_1_2_01-lib-linux-i586-jre.bin
            ./jai-1_1_2_01-lib-linux-i586-jre.bin

 3-3 Installing JavaPOS Driver
     [In case of Full install]
        Execute the JavaPOS install file :
          installJavaPOSFull.sh
        - Please refer to SupportedDevicesList.txt for the list of supported 
          devices.

     [In case of no SetupPOS install]
        Execute the JavaPOS install file :
          installJavaPOSNoSetupPOS.sh

        Support devices are as follows.
          - TM-H6000III
          - TM-H6000IV
          - TM-H6000V
          - TM-H6000VI
          - TM-m10
          - TM-m30
          - TM-m30II
          - TM-m30III
          - TM-m50
          - TM-m50II
          - TM-T70
          - TM-T70II
          - TM-T100
          - TM-T20
          - TM-T20II
          - TM-T20III
          - TM-T20IIIL
          - TM-T20IV-L
          - TM-T20X
          - TM-T20X-II
          - TM-T81III
          - TM-T82III
          - TM-T82IIIL
          - TM-T82IV-L
          - TM-T82X
          - TM-T82X-II
          - TM-T83III
          - TM-T83IV
          - TM-T88III
          - TM-T88IV
          - TM-T88V
          - TM-T88VI
          - TM-T88VII
          - TM-L100
          - TM-P80II
          - TM-P20II
          - TM-U220IIA/B/D

        [Note]
           CashDrawer, LineDisplay, MICR, CheckScanner and ElectronicJournal 
           are not supported.

 3-4 Device Registration
     [In case of Full install]
        1. Type the following at the terminal to change to you home directory:
            cd /opt/EpsonJavaPOS/SetupPOS
        2. Execute the SetupPOS:
            ./SetupPOS
        3. Refer to the SetupPOS manual (SetupPOSManual.pdf) for instructions on
           device registration.

     [In case of no SetupPOS install]
       1.Please create jpos.xml by referring to the file of xml folder.
       2.Please put the created jpos.xml in the folder where the application is 
         located.
           ex) Put jpos.xml in /opt/EpsonJavaPOS/checkhealth.


Chapter4 Make same enviroment:
  Make master PC and target PC the same distribution and 
  an installation destination.

    1. Install in a master PC by a procedure of Chapter3, and register a device.
    2. Install in a target PC by a procedure of Chapter3.
    3. Copy the following file from a master PC to a target PC.
         cp ./jpos.xml <same directory as copy source>
         cp ./jpos1141.jar <same directory as copy source>
         cp ./pcs.properties /var/epson_pcs/portcommunicationservice/

